home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / byepc300.zip / BYE-PC.DOC < prev    next >
Text File  |  1987-01-03  |  48KB  |  1,590 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                   BYE-PC Resident Modem Driver
  12.                            with
  13.                        DOS Interface
  14.  
  15.               Manual Version 1.0 - February, 1987
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.      This  document  describes  the operation of BYE-PC  and  the
  43. application interfaces required to access functions that  control
  44. modem  operations.  It  is  not intended as a reference  to  8086
  45. assembly language or the 'C' programming language,  but serves to
  46. provide a description of the operation and uses of BYE-PC.
  47.  
  48.  
  49.                            by
  50.  
  51.                      MCODE Software
  52.                     3444 Dresden Drive
  53.                  Montgomery, Alabama, 36111
  54.                       (205)244-7230
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.              Copyright (C) 1986, 1987 MCODE Software
  64.  
  65.      All  of  the  source code is copyrighted material  by  MCODE
  66. Software.  The  author  retains  all rights to  the  source  code
  67. provided in this package. This code may not be distributed in any
  68. modified form without written or verbal consent from the  author.
  69. Any  form of sale other than MCODE Software is  prohibited.  This
  70. software  may  not  be offered for sale by any means or  form  to
  71. others without written permission from MCODE Software.
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.                          DISCLAIMER
  86.  
  87.      The  author has taken great care to insure that this  manual
  88. and  associated software provide accurate information in  regards
  89. to the documentation and source code provided.  Any references to
  90. particular  compilers,  linkers  or other development  tools  are
  91. believed to be true by the author.  No warranty is made regarding
  92. the  fitness  or validity of such material for any  circumstance.
  93. Hardware  and  software compatibility is not guaranteed  for  any
  94. particular  types of machines other than those mentioned in  this
  95. manual.  This software has been tested extensively under specific
  96. operating  environments and is believed to operate  as  described
  97. within  this  manual.  In  no event will MCODE  software  or  the
  98. authors  be held liable for damages of any kind,  in regard to or
  99. arising  from the use of accompanying software or and  documenta
  100. tion.  No  representation to the suitablity for this product  for
  101. any use is made by the author.
  102.  
  103.  
  104.      BYE-PC is a Tradmark of MCODE Software.  IBM, IBM PC, PC XT,
  105. PC  AT,  DOS  and PCDOS are Tradmarks of  International  Business
  106. Machines Corp.   Microsoft C,  MSDOS, ASM, and MASM are Tradmarks
  107. of Microsoft Corp.  Hayes, Smartmodem, Smartmodem 300, Smartmodem
  108. 1200 are trademarks of Hayes Microcomputer Products Inc.  CP/M is
  109. a tradmark of the Digital Research Corp.
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.                   TABLE OF CONTENTS
  117.  
  118.  
  119. Introduction.........................................
  120.  
  121. Compiler Information.................................
  122.  
  123. Configuring BYE-PC for your system...................
  124.  
  125. BYE-PC Program Structure.............................
  126.  
  127. Interface to application programs....................
  128.  
  129. Caller status word...................................
  130.  
  131. Getting Started......................................
  132.  
  133. Program Operating structure..........................
  134.  
  135. Interface functions..................................
  136.  
  137. Compiling BYE.ASM Source Code........................
  138.  
  139. Telebit Trailblazer(tm) 9600bps high speed modem.....
  140. .PA
  141.                      INTRODUCTION
  142.  
  143.  
  144.      Welcome  to BYE-PC!  Your support is greatly appreciated and
  145. we sincerely thank you for using our product. It is our hope
  146. that you will benifit and learn from the provided source code. If
  147. you  are  an accomplished programmer and already  understand  the
  148. operations  of  interrupt driven software,  please send  us  your
  149. comments,   advice  or  any  other  suggestions  concerning  this
  150. package.  We  hope that you will enjoy using this package as much
  151. as  we have in providing it.  Contact us if you  are  having  any
  152. problems  setting  up the system and we will try to  provide  you
  153. with  an  answer or solution.  It is recommended  that  a  $30.00
  154. donation  be  made  to the author if you use this  program  on  a
  155. regular  basis.  Registered users will receive technical  support
  156. only.  PLEASE  DON'T  BOTHER TO CALL IF YOU ARE NOT A  REGISTERED
  157. USER!
  158.  
  159.      MCODE  Software  will  provide  all  registered  users  with
  160. updates  for  an  unlimited period of time.  Users  that  request
  161. updates will have to provide for any shipping and disk cost at  a
  162. very minimal fee. Also, we plan to keep the latest copies of BYE-
  163. PC  and  related  programs available for downloads at  any  time.
  164. Please keep in touch with us via the Board Walk RBBS distribution
  165. point in Montgomery,  Alabama at (205)277-3882 or write to us  at
  166. MCODE  Software.  There are still many new features in the making
  167. and  we  want you to receive the latest versions as soon  as  re
  168. leased.
  169.  
  170.  
  171. WHAT IS BYE-PC?
  172.  
  173.      BYE-PC  is a memory resident modem driver that is  interrupt
  174. driven to provide fast reliable serial communications with  phone
  175. modems.  BYE-PC  is  a  complete implementation of the  BYE  CP/M
  176. version  offered  in  the  public domain for  use  on  eight  bit
  177. systems.  The  CP/M implementation does not support rs232  driven
  178. interrupts and is much slower than BYE-PC. BYE-PC allows for full
  179. keyboard  type ahead from the remote station.  Characters may  be
  180. received during other processes without polling the receive  port
  181. for a data ready signal.
  182.  
  183.      Please  be  sure and read  the  supplementary  documentation
  184. files that exsists.  These files contain important information on
  185. recent updates that may have occured:
  186.  
  187.                READ.ME        ----      Latest modifications
  188.  
  189. Any recent modifications that occur since the last manual  publi
  190. cation,  are contained in the file READ.ME.  Please read the copy
  191. right notice and license agreement in the file COPYRGHT.BYE.
  192. .PA
  193. WHAT WILL BYE-PC DO?
  194.  
  195.      An  IBM  PC,  PC XT,  or PC AT host computer running  BYE-PC
  196. allows a remote callers access to DOS. A series of interrupts are
  197. overtaken  and/or chained that patch the modem i/o  signals  into
  198. the  BIOS.  Since  DOS makes calls through the BIOS,  almost  any
  199. program  that does not access the serial port or screen  directly
  200. will run under BYE-PC. Although the large majority of programs do
  201. not  adhere to these rules,  most programs that are well  behaved
  202. and write to 'stdin' and 'stdout' will run properly under BYE-PC.
  203. For instance,  DEBUG may run remotely to allow viewing the system
  204. internally,  or file archive utilities such as ARC,  ZOO, etc...,
  205. may be used.
  206.  
  207.     Once a caller has established a connection, BYE-PC allows the
  208. option to execute a .COM or .EXE file.  This allows any number of
  209. programs,  such  as bulletin boards,  to receive  control  before
  210. allowing  users to enter DOS.  Since any DOS commands may be exe
  211. cuted  while  running BYE-PC,  users  have  complete  control.  A
  212. security shell is provided that parses all DOS commands prior  to
  213. execution by COMMAND.COM. This allows selective commands to check
  214. internal status before execution to eliminate unwanted  commands,
  215. paths, drives or DOS functions.
  216.  
  217.      Currently  all  application programs that provide access  to
  218. BYE-PC such as XMODEM,  CHAT,  STAT,  and RBBS, are created using
  219. the Microsoft C compiler.   A standard interface is provided that
  220. allows  C  programs  direct control  over  the  host  system.  An
  221. application  may  disconnect,  check  status,  or  change  values
  222. within BYE-PC through an additional software interrupt.  Assembly
  223. language  routines  may  call  BYE-PC functions as  easily  as  C
  224. applications through the system control interrupt (SCI).
  225.  
  226.      Since  all  data  is  received  from  hardware   interrupts,
  227. characters are stored in a buffer within BYE-PC as each interrupt
  228. occurs.  All  requests for data are made through the SCI and  the
  229. provided  C  interface BYEXFACE.C.  These topics are  covered  in
  230. greater detail in the following sections of this manual. Hardware
  231. interrupts  occur  with changes of state in the  rs-232  serial
  232. port  card.  I